全球首个且最好的专为 AI 智能体设计的 Office 套件

373 字

小G GitHubStore 2026年6月22日 08:54

以前每次让AI帮忙做个PPT或者改Excel,总觉得它“懂个大概”,但真正动手时不是格式乱七八糟,就是直接卡壳。

且传统方式用Python处理Office文件,常常要装一堆库,代码写几十行,还容易出兼容问题。尤其是复杂图表、样式、国际化支持,动不动就翻车。

什么是OfficeCLI?

简单说,它是一个专为AI智能体设计的Office工具套件。开源免费、单文件运行、无需安装Microsoft Office,全平台都能用。 它最大的亮点在于:不仅能让AI读写Word、Excel、PowerPoint,还内置了渲染引擎,能把文档实时转成HTML或图片,AI“看”得见自己做的效果,改起来自然就准多了。

OfficeCLI 是全球首个、也是最好的专为 AI 智能体设计的 Office 套件。

让任何 AI 智能体完全掌控 Word、Excel 和 PowerPoint——只需一行代码。

开源免费。单一可执行文件。无需安装 Office。零依赖。全平台运行。

内置 agent 友好渲染引擎 —— 智能体可以“看见”自己创建的内容,无需 Office。把 .docx / .xlsx / .pptx 渲染为 HTML 或 PNG,“渲染 → 看 → 改”循环在二进制能运行的任何地方都成立。

AI 智能体 — 一行搞定

把下面这行命令粘贴到你的 AI 智能体对话框中,它会自动读取技能文件并完成安装:

curl -fsSL https://officecli.ai/SKILL.md

仅此一步。技能文件会教智能体如何安装二进制文件并使用所有命令。

普通用户

方式 A — 图形界面: 安装 AionUi —— 一款桌面应用,支持用自然语言创建和编辑 Office 文档,底层由 OfficeCLI 驱动。只需描述你想要什么,AionUi 就会帮你完成。

方式 B — 命令行: 从 GitHub Releases 下载对应平台的二进制文件,然后运行:

officecli install

此命令会将二进制文件复制到 PATH,并自动将 officecli 技能文件 安装到检测到的所有 AI 编程助手(如 Claude Code、Cursor、Windsurf、GitHub Copilot 等)。你的智能体可以立即为你创建、读取和编辑 Office 文档,无需额外配置。

快速开始

# 创建演示文稿并添加内容
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
officecli add deck.pptx '/slide[1]' --type shape \
  --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \
  --prop font=Arial --prop size=24 --prop color=FFFFFF

# 查看大纲
officecli view deck.pptx outline

# 查看 HTML 渲染预览
officecli view deck.pptx html

# 获取结构化 JSON
officecli get deck.pptx '/slide[1]/shape[1]' --json

# 保存并关闭
officecli close deck.pptx

关键技术

1. 编程语言与运行时

  • C# +.NET :整个项目核心使用 C# 开发( src/officecli/ 目录下大量 .cs 文件,包含 officecli.csproj )。
  • 单文件自包含发布 :使用.NET 的 Single-File Publish + Native AOT (或 trimmed self-contained)技术,打包成 零依赖单二进制文件 ,支持 Windows、macOS、Linux 全平台,无需安装.NET 运行时。
  • 项目使用 officecli.slnx 解决方案文件,构建脚本 build.sh

2. Office 文件处理核心:Open XML SDK

  • DocumentFormat.OpenXml (NuGet 包)是底层基础库。
  • 直接操作 OOXML(Office Open XML)格式(ZIP 包 + XML 部件),无需 Microsoft Office 安装或 COM 互操作。
  • 优势:跨平台、精确控制结构、样式、公式、图表等,避免传统 Python 库(如 python-docx、python-pptx、openpyxl)的兼容性和功能局限。

3. 架构设计:模块化 Handler + Core 引擎

  • DocumentHandlerFactory :根据文件扩展名(.docx /.xlsx /.pptx)分发到对应 Handler:
  • WordHandler.cs
    • ExcelHandler.cs
    • PowerPointHandler.cs
  • Core/ 目录:共享基础设施
  • HtmlPreviewHelper.csHtmlScreenshot.cs :内置 HTML/PNG 渲染(代理友好,AI 可“看见”输出)。
    • watch 命令实时预览(本地 HTTP 服务 + 自动刷新)。
  • 路径查询系统 :自定义 CSS-like / XPath-like 选择器( GenericXmlQuery.csSelectorPositionalIndex.csPathAliases.cs ),支持 /slide[1]/shape[2] 、Excel 行过滤 row[Salary>5000 and Region=EMEA] 等。
    • DOM-like 抽象DocumentNode.cs 等模型,便于 AI 友好操作。
    • 渲染引擎
    • Resident Mode (常驻模式): ResidentServer.cs / ResidentClient.cs ,保持文档在内存中,批量操作时避免反复打开/保存,提升性能。

4. 高级功能实现

  • Excel 公式与 Pivot
  • Core/Formula/ 目录:内置 150+ 函数求值引擎、公式引用重写( FormulaRefShifter.cs )。
    • PivotTableHelper.cs (多文件):完整支持 PivotTable 创建、缓存、布局、计算字段等,原生 OOXML 输出。
  • 国际化与复杂特性
  • BCP-47 语言标签、 LocaleFontRegistry.csWordStrictAttributeSanitizer.cs 等,支持 RTL、CJK、复杂脚本。
    • 修订追踪(revisions)、批注、域、内容控件(SDT)、OLE 对象等深度支持。
  • 插件系统Core/Plugins/ ):扩展 PDF 导出、其他格式等。
  • Batch / Dump / Merge :JSON 序列化/反序列化,支持 round-trip(dump → batch 编辑)。
  • 验证与诊断 :OpenXML Schema 验证 + 自定义 Issue 检测(溢出、缺失 alt text 等)。

5. AI 代理优化特性

  • 命令行友好 :丰富 CLI(System.CommandLine 或类似), CommandBuilder.*.cs 分模块处理 add/set/get 等。
  • JSON 输出 :结构化结果,便于 AI 解析和链式调用。
  • Skill / MCP 支持 :内置 SKILL.md 安装、MCP Server(Model Context Protocol),无缝集成 Claude、Cursor 等 AI 工具。
  • 无头 / CI 友好 :渲染、预览、批处理均支持无界面环境。

6. 其他技术亮点

  • 性能与兼容 :EMU 单位转换、 EmuConverter.csUnits.cs ;颜色主题解析、 ThemeHandler.cs ;字体度量、 FontMetricsReader.cs
  • 安全与构建 :GitHub Actions CI、代码签名(macOS notarization)、第三方通知。
  • 辅助工具 :模板合并( TemplateMerger.cs )、CSV 导入、图像/SVG 处理等。

项目地址

https://github.com/iOfficeAI/OfficeCLI

如果你觉得这篇文章不错,别忘了 点赞、在 看、转发 给更多需要的小伙伴哦!

AIAgent · 目录

继续滑动看下一个

GitHubStore

向上滑动看下一个